home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / util / boot / RNDBackdrop.lha / rndbackdrop / Readme
Text File  |  1995-08-08  |  4KB  |  93 lines
  1.         RndBackdrop V1.0  ScanPicDir V1.0
  2.         ---------------------------------
  3.  
  4. Purpose
  5. -------
  6.  
  7. Two little programs I've written in ARexx, because similar programs on 
  8. aminet did not support reloading of a random picture, in case I get annoyed
  9. of a picture but don't want to reboot (moreover WBPattern can't simply 
  10. reload a picture by giving a picture as argument to it, don't know about
  11. WBPicture (NickPrefs) though.).
  12.  
  13. Disclaimer
  14. ----------
  15.  
  16. No warranties are given for my ARexx scripts. Of course you can send
  17. me bug reports, see BUG section below.
  18.  
  19. Copyright
  20. ---------
  21.  
  22. Both scripts are Public Domain. You may use it as you wish, but it would
  23. be nice if you mentioned me somewhere when you include them in one of your
  24. programs, my name is Reinhard Katzmann and I live in Tuebingen, Germany.
  25.  
  26. Introduction
  27. ------------
  28.  
  29. As I shortly scanned several backdrops I thought it would be good to find
  30. a program which selects a random picture and displays it on the WB screen.
  31. WBPattern (supplied with OS3.x) though only can only display one fixed 
  32. picture. Therefore I wrote an ARexx script to do the job. Besides I had to
  33. find out that I could not simply give a picture as argument, but had to
  34. change the fixed picture file. To avoid search time, I wrote a second
  35. script which creates a backdrop list of your pictures (you might even want
  36. to change it by hand). From this list the other script selects a random
  37. picture and copies it to the fixed one.
  38.  
  39. Usage
  40. -----
  41.  
  42. ScanPicDir scans one or more directories with backdrop pictures for your
  43. WB and builds a list which RndBackdrop uses to select a random picture.
  44.  
  45. Usage: RX ScanPicDir Paths/M,Pattern/K,ALL/S,DIR/S,Outfile/K
  46.  
  47. Outfile is preconfigured as dh0:t/backdrops. Other arguments are similar
  48. the List AmigaDos Command with exception that Paths being only directories.
  49.  
  50.  
  51. RndBackdrop selects the picture and copies it to the fixed file. You can
  52. use it in your User-Startup (before loading WB) or as online command.
  53. Actually none of the arguments below must be given to run the script.
  54.  
  55. Usage: RX rndbackdrop TO,Infile/K,TMPFile/K,TMPPrefs/K,RELOAD/S,MSG/S
  56.  
  57. TO is the name of the fixed picture file (defaults to dh0:t/bdpic). The name
  58. of this pictures must be also the name of the pic in WBPattern (be sure
  59. to have actually copied a pic file before calling WBPattern :-)
  60. Infile is the the name of the picture list (every entry must have the full
  61. path of the pic). If you use the MSG switch, you will see which file has been
  62. choosen by the program. That are all arguments needed for User-Startup usage.
  63.  
  64. If you want to change the backdrop AFTER the Workbench has been loaded you must
  65. give at least the RELOAD switch as argument. The ARexx script must rename the
  66. backdrop file to TMPfile (default oldpic) (because WBPattern has a lock on it),
  67. then copies as above and calls WBPattern itself twice (*sigh* you cannot simply
  68. use the same prefs with WBPattern again, WBPattern will not reload the new picture,
  69. a notify would be helpful here, ESCOM ? :-), one with an empty prefs (you can
  70. use the one I included) TMPPrefs and after that the original Prefs. Then it
  71. waits a second until the lock is away and deletes the old picture. (Hope your
  72. mind has no knot after this paragraph ;-)
  73.  
  74. If you don't own OS3.x, but use instead OS2.x including WBPicture (or a similar
  75. program), you might set the ENV-Variable WBBACKDROPCMD (default is for OS3.0
  76. User: 'WBPattern use' (without quotes) ). Didn't test this, though.
  77.  
  78. Bugs
  79. ----
  80.  
  81. Not that I knew some ;-). The only thing I encountered is a general problem with
  82. csh (5.43) and ReadArgs() from RexxDosSupport. But I think it will be generally
  83. used from User-Startup or as WBScript or from ToolsMenu.
  84.  
  85. If you still have bugs/problems/ideas/, feel free to send me an email.
  86.  
  87. EMAIL ADRESS:  Suamor@student.uni-tuebingen.de (Reinhard Katzmann)
  88.  
  89. History
  90. -------
  91.  
  92. V1.0 - Initial release
  93.